BREAKING CHANGE for 2021.1 (specifically 2021.1.4)
The following are breaking changes for the 2021.1.4 release.
API Changes for Pre-built Automations
Overall, multiple changes have been made to the Pre-built Automation APIs in an effort to give users the ability to overwrite Pre-built Automations when the Pre-builts are installed or imported into an Itential Automation Platform (IAP) environment. In order to accomplish this functionality change, some breaking changes have been introduced to several of these Pre-built APIs which has been explained further below.
POST /prebuilts/import
The main breaking change for the importPrebuilt API is the introduction of the optional parameter overwrite. Now when making a request to POST /prebuilts/import the request body should be as follows:
{
"prebuilt": { ... },
"options": {
"overwrite": true or false
}
}This functionality now allows a user to specify if they would like to "overwrite" any existing Pre-built component documents already on the system.
For example, let's say there is a Pre-built Automation that contains a workflow document (Workflow A) and this workflow document already exists in the current IAP environment. If the user chooses to import the Pre-built with overwrite = false, then the import process will fail saying a workflow document (Workflow A) already exists in your IAP environment. If the user chooses to import the Pre-built with overwrite = true the import process will continue and the incoming workflow document will be processed and used to replace the existing workflow document that is in the IAP environment.
Additional breaking changes to the importPrebuilt API are the improvement to the error handling. The error responses of the API are much more verbose and compartmentalized. This means that the import process will capture errors from each component and handle it separately as if it was an independent process. This allows the user to better understand which aspects of the Pre-built contributed to a failed import.
DELETE /prebuilts/:id
The only change to the deletePrebuilt API is the process will only remove the Pre-built document from the IAP environment. Any referenced component within the Pre-built (i.e. workflows, json-forms, transformations, etc.) will not be removed and remain on the system.
What should I do?
Review any custom apps and adapters that might reference any APIs mentioned above and change them accordingly; otherwise, please use this newly revamped system as we believe the experience is better than the previous one.